Chapter 5 - Ink Objects
This chapter describes ink objects and the functions you can use to manipulate them. Read this chapter if you create or use any kind of ink object for the QuickDraw GX shapes you create. Read this chapter also if you want to understand how QuickDraw GX uses transfer modes in drawing shapes.Before reading this chapter, you should be familiar with the information in the chapter "Introduction to QuickDraw GX" in this book. You should also be familiar with shapes, as discussed in the chapter "Shape Objects" in this book.
Although colors are contained in ink objects, they are not discussed here. Colors are discussed in the chapter "Colors and Color-Related Objects" in this book. Other than that chapter, this chapter constitutes the complete discussion of ink objects for QuickDraw GX. Unlike for shape objects and style objects, there is no separate discussion in other books of any specific graphic or typographic uses for inks.
This chapter introduces QuickDraw GX ink objects and describes their properties. It also describes how transfer modes work in QuickDraw GX. It then shows how to use the QuickDraw GX ink-manipulation functions to
- create and manipulate ink objects
- manipulate ink object properties
- get and set an ink object's color
- work with transfer modes
Chapter Contents
- About Ink Objects
- Ink Properties
- Color
- Transfer Mode
- Ink Attributes
- The Default Ink Object
- About Transfer Modes
- Transfer Mode Types
- Arithmetic Transfer Modes
- Highlight Transfer Mode
- Boolean Transfer Modes
- Pseudo-Boolean Transfer Modes
- Alpha-Channel Transfer Modes
- Modes for the Color Components
- Modes for the Alpha Channel
- Transparency Ramps and Anti-Aliasing
- Transfer Mode Color Space
- Color Limits
- Source Color Limits
- Destination Color Limits
- Result Color Limits
- Transfer Mode Matrices
- Flags
- Transfer Component Flags
- Transfer Mode Flags
- Summary of Transfer Mode Operation
- Using Ink Objects
- Creating and Manipulating Ink Objects
- Creating and Disposing of Ink Objects
- Copying, Comparing, and Cloning Ink Objects
- Loading and Unloading Ink Objects
- Manipulating Ink Object Properties
- Getting and Setting an Ink Object's Attributes
- Manipulating an Ink Object's Owner Count
- Getting and Setting an Ink Object's Tag References
- Getting and Setting an Ink Object's Color
- Getting and Setting an Ink Object's Transfer Mode
- Working With Transfer Modes
- Simple Source-to-Destination Transfers
- Drawing Selected Parts of the Source
- Preserving Selected Parts of the Destination
- Copying or Preserving Luminance
- Modifying Luminance
- Isolating and Modifying Color Ranges
- Masking
- Partial Transparency
- Anti-Aliasing
- Making Color Separations
- Transfer Modes and Printing
- Ink Objects Reference
- Constants and Data Types
- The Ink Object
- Ink Attributes
- Color Structure
- Transfer Mode Structure
- Transfer Mode Flags
- Transfer Component Structure
- Component Modes (Transfer Mode Types)
- Transfer Component Flags
- Functions
- Creating and Manipulating Ink Objects
- Manipulating Ink Object Properties
- Getting and Setting an Ink's Color
- Getting and Setting an Ink's Transfer Mode
- Summary of Ink Objects
- Constants and Data Types
- The Ink Object
- Ink Attributes
- The Color Structure
- The Transfer Mode Structure
- Transfer Mode Flags
- The Transfer Component Structure
- Component Modes
- Transfer Component Flags
- Functions
- Creating and Manipulating Ink Objects
- Manipulating Ink Object Properties
- Getting and Setting an Ink's Color
- Getting and Setting an Ink's Transfer Mode